Chapter 4-8: Runtime Subroutine's and Predefined Processes

.UTIL DEL HOOK

This subroutine deletes a record from the Hook file.

Usage:

Description:

This subroutine deletes a record from the Hook file. All parameters are required, if any required parameters are missing, the subroutine will CANCEL.

<error_msg> will contain a detailed error message if the Hook record was not able to be deleted (Required). This must be PASSed Share "Y" to return the value.

HOOK RECORD is the record structure containing the Hook information (Required).

The mandatory fields are:

HOOK AP:
HOOK VER:
HOOK PROC TYPE:
HOOK PROC NAM:
HOOK DB:
HOOK USER ID:

The above fields identify the hook record to be deleted. (Application, Version, Process Type, Process Name, Database and User Id). The remaining fields will be ignored.

This subroutine is different from .UTIL GET HOOK RECORDS/.UTIL PUT HOOK RECORDS in that the the changes are permanent, and they do not take effect immediately. If you want the changes to take effect immediately, use.UTIL GET HOOK RECORDS to get the current hook records from the engine, make the same changes as you did with this subroutine, then update the engine with.UTIL PUT HOOK RECORDS. Or you can do nothing, and the changes will take effect the next time users log on.

Also see .UTIL ADD HOOK and .UTIL CHG HOOK.

Note that although --- HOOK is an indexed file that can contain more than one record, only the current record buffer will be processed.

Application Design Manual                                         "Powered by Appx Software"

1177

©2006 By APPX Software, Inc. All Rights Reserved